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Command> show clock 
' * 04:10:12. 621 UTC Thu May 6, 1993 



/ ^^Command> snow clock detail 
205 *04.10.18.109 UTC Thu May 6, 1998 
Time source is user configuration 



r </xml version="1 .0" endodings="US-ASCN"?> 
<!D0CTYPE cli SYSTEM "cli.dtd'i> 
<cli> 

<mode name='t|lobal'!> 

<command> 

<keyword text= £ show'V 

<help>Show running system intormation</help> 
— <!-lots of other show keywords. . . --> 



210 < 



<keyword text='clock'!> 

<?help>display the system clock</help> 
<action object= 'Clock" method='show'!> — \_ 
</action> 

<keyword text= 'details 
<help>Display detailed information </help> 
action object='Clock" method='fchowDetail'i> 
</action> \ 
</keyword> ^ 
</keyword> ^ 
</keyword> 215 
</command> 
</mode> 
</cli> 
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321 



Command > clock set? 

hh:mm:ss Current Time 



Command > clock set 00:00:00 ? 

322 <1 " 31 > Da y of tne Montn 

Month of the Year 

_ t Command > clock set 00:00:00 25 Sep ? 
32 <P- / <1993-2035>fear 



Command > clock set 00:00:00 25 Sep 2000 

324 

Command > 



C <command> 

<keyword text="clock'!> 327 
<help>Manage the System clock</help> 
<keyword text="set'i> 328 

<help> Set the time and date</help> 
<action object="Clock" method="set'!> 329 
<arg> <!-time argument -> 

<typetype="java.land.String"x/type> 
<help>hh:mm:ss Current Time </help> "~ 
</arg> 

<arg> <!-day of the month argument --> 
<ty pe type="java.iang . I nteger"></type> 
one J <help>&1t;1-31> Day of the month</help? 

^ b " </arg> 

<arg> <!-day of the month argument --> 
<type type="java.lang.lnteger"></type> 
<help>Month Month of the year </help> 
</arg> 

<arg> <!-year argument --> 
<ty pe type="java.lang . I nteger"></type> 
<help>&1t;1993-2035> Year</help> — 
</arg> 
</action> 
</keyword> 
</keyword> 
V </command> 
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<?xml version =1.0' encoding="us-ascii'?> 
<!-DTD for cli description file — > 

<!-The cli tag is the topmost element. Contains zero or more modes. -> 
<!ELEMENT cli (mode*)> 

<!--The mode tag contains zero or more command tags. The mode must 
have a name, for example "golbal" " exec", " config" --> 

<!ELEMENT mode (command*)> 

<!ATTLIST mode 

name CDATA#REQUIRED 

> 

<!-The command tag contains a single keyword--> 
<!ELEMENT command (keyword)> 

<!--The keyword tag contains zero or more subkeywords, with an optional 

single instance of action or help. The single attribute is the keyword test 

which must be present -> 
<!ELEMENT keyword ((keyword)*, action?, help?> 
<!ATTLIST keyword 

test CDATA#REQUI RED 

> 

<!-- The action tag contains zero or more argument tags. The "object" 
and "method" attributes must be present and defined" 
<!ELEMENT action (arg*)> 
<!ATTLIST action 

object CDATA#REQUIRED 

method CDATA#REQUIRED 

> 

<!-- The arg tag contains a single instance of a type tag and an 
optional help tag --> 
<!ELEMENT arg (type,help?)> 

<!--The type tag is an empty tag with a required attribute "type". The 

value of the attribute should be a Java class name --> 
(IELEMENT type EMPTY)> 
<!ATTLIST arg 

type CDATA /REQUIRED 



<!-- The help tag encloses some text --> 
<! ELEMENT help (#PCDATA)> 
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show clock detail show clock detail show clock detail show clock detail 

1105 1110 1115 1120 
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1305 



Command 


Keyword Set 


show date 


("show"," date') 


show date detail 


("show"," date"," detail') 


clock set 


("clock"," set') 
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Argument 
Number 


Argument Description 


Argument Help 


1 


Time in 00:00:00 format 


hh:mm:ss Current time 


2 


day of the month in integer 
format 


<1 -31 > Day of the month 


3 


month in three letter 
format 


MONTH Month of the Year 


4 


Year in integer format 


<1993-2035>Year 
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Command 
Keyword Sequence 


Help 


show 


show running system Information 


clock 


Manage the system clock 


show clock 


Display the system clock 


show clock detail 


Display detailed information 


clock set 


Set the time and date 
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<?xml version='1.0 encoding='US...ASCir ?> 

<! DOCTYPE cli SYSTEM "cli.dtd'b* 

<cli> 

<mode name="exec'5> 

<command> 

<keyword text= "show" > 

<help>Show running system information</help> 

.... <!--lots of other show keywords... --> 

<keyword text=" clock'> 
</help>Display the system clock </help> 
<action object="Clock" method= "show'i> 
</action> 

<keyword text="detairv 
<help>Display detailed information</help> 
action object="Clock" method="showDetail'i> 
</action> 
</keyword> 
</keyword> 
< / command> 
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<command> 

<keyword text="clock" 
<help>Manage the System clock</help> 

<keyword test="set'5> 

<help> Set the time and date</help> 

<action object="Clock" method="set% 

<arg><!- time argument -> 
<type type="Java.land.String"></type> 
<help>hh:mm:ss Current time</heip> 
</arg> 

<arg> <! - day of the month argument -> 
<type type=Java.land.lnteger"></type> 
<help><1-31> day of the month</help> 
</arg> 

<arg> <! day of the month argument -> 
<ty pe ty pe=" Java, land . I ntege r"></type> 
<help>MONTH Month of the year</help> 
</arg> 

<arg> <! year argument --> 
<type type="Java.land.lnteger"></type> 
<help><1 993-2035> Year</help> 
</arg> 

</action> 
</keyword> 
</keyword> 
< / command> 
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public void show () { 

SimpleDateFormat formatter = 
new SimpleDateFormat ("hh:mm:ss.SSS zzz EEE 
MMM dd yyyy"); 

System.out.println("*" + formatter.format 
(new Date())); 
} 

public void showDetail () { 

this.show(); 

if (Clock.source()) 

System.outprintln ("Time source is user 
configuration"); 

else 

System.outprintln ("No time source"); 
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public void set (String time, Integer day, String month, Integer year) 

throws lOException, InterruptedException, CLIArgumentException 
( 

//Validate the arguments 
SimpleDateFormat format = new SimpleDateFormat fhh:mm:ss); 
formatsetLenient (false); 
try {format parse (time) 
} catch (ParseException e) { 

throw new ArgumentException (1); 

} 

if (day.intValue() < 1 1 1 day.intValue() > 31) 
throw new ArgumentException (2); 

formatapplyPattem ("MMM"); 
try { formatparse(month); 
} catch (ParseException e) { 

throw new ArgumentException (3); 

} 

if (year.intValue() < 1 993 1 1 year.intValue 0> 2035 
throw new ArgumentException (4); 

// One last check for day, month and year validity (e.g., Feb 31) 
formatapplyPattem (" dd MMM yyy"); 
try {format.parse(day.toString() + month + year.toString()); 
} catch (parseException e) { 

CLIEng ine.out. printl n(" I nvalid date (doesn't exist)"); 

Return; 

} 

//Do the actual work 
String [] cmd = {" /bin/date", " -s" time + + day + + month + "" + year 

}; 

Process proc = Rumtime.getRuntime().exec (Cmd); 
proc. waitFor(); if (proc.exitValue() > 0) { 
CLIEngine.err.println("Operation not permitted"); 
return; 

} 

clock.sourceSet() ; 
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